/**
 * <h3>CampusNewsController</h3>
 * <p> 校园新闻信息管理控制器类 </p>
 *
 * <h3>功能描述</h3>
 * <p> 提供校园新闻信息的增删改查等基础操作接口，统一返回AjaxResult格式结果 </p>
 * <p> 所有接口均基于RESTful风格设计，配合SpringMVC与Swagger注解实现标准化API输出 </p>
 *
 * <h3>元数据</h3>
 * <ul>
 *    <li> 作者：郭强 </li>
 *    <li> 创建日期：2025年05月20日 21:09:09 </li>
 * </ul>
 *
 * <h3>其他信息</h3>
 * <ul>
 *    <li> 参考链接：<a href="https://fantastic-admin.hurui.me/guide/permission.html">权限控制文档</a></li>
 *    <li> 示例代码：{@code new CampusNewsController()} </li>
 * </ul>
 *
 * @apiNote 接口需结合前端权限配置使用，确保安全性；当前未启用权限注解
 * @implSpec 继承自 {@link BaseController}，复用分页、返回封装等通用逻辑
 * @since v1.0.0.0
 */

package com.dnndo.web.controller.system;

import com.dnndo.common.annotation.Log;
import com.dnndo.common.core.controller.BaseController;
import com.dnndo.common.core.domain.AjaxResult;
import com.dnndo.common.core.domain.PageResult;
import com.dnndo.common.core.domain.R;
import com.dnndo.common.enums.BusinessType;
import com.dnndo.common.utils.bean.BeanDtoVoUtil;
import com.dnndo.system.domain.CampusNews;
import com.dnndo.system.domain.dto.CampusNewsDTO;
import com.dnndo.system.domain.vo.CampusNewsVO;
import com.dnndo.system.service.ICampusNewsService;
import com.github.pagehelper.PageInfo;
import io.swagger.annotations.ApiParam;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.security.access.prepost.PreAuthorize;
import org.springframework.validation.annotation.Validated;
import org.springframework.web.bind.annotation.*;

import java.util.List;

/**
 * 校园新闻信息controller类
 *
 * @author 郭强
 */
@RestController
@RequestMapping("/system/campusnews")
public class CampusNewsController extends BaseController {

    private final ICampusNewsService campusNewsService;

    @Autowired
    public CampusNewsController(ICampusNewsService campusNewsService) {
        this.campusNewsService = campusNewsService;
    }

    /**
     * 查询校园新闻列表（分页）
     *
     * @param dto 新闻查询条件封装对象，包含标题、学校ID等过滤条件
     * @return PageResult<CampusNewsVO> 分页后的新闻信息列表及总记录数
     * @see CampusNewsVO
     */
    @PreAuthorize("@ss.hasPermi('campusnews:list1')")
    @GetMapping("/list")
    public PageResult<CampusNewsVO> list(CampusNewsDTO dto) {
        startPage();
        List<CampusNews> list = campusNewsService.selectCampusNewsList(dto);
        return PageResult.pageOk(BeanDtoVoUtil.listVo(list, CampusNewsVO.class), new PageInfo<>(list).getTotal());
    }

    /**
     * 根据新闻ID获取详细信息
     *
     * @param newsId 新闻唯一标识符
     * @return AjaxResult 包含新闻详细信息的响应结果
     * @see CampusNewsVO
     */
    @GetMapping("/getInfo")
    public AjaxResult getInfo(@ApiParam(value = "新闻ID", required = true) Long newsId) {
        CampusNewsDTO campusNews = campusNewsService.selectCampusNewsById(newsId);
        return AjaxResult.success(R.ok(BeanDtoVoUtil.convert(campusNews, CampusNewsVO.class)));
    }

    /**
     * 新增校园新闻信息
     *
     * @param dto 前端传入的新闻数据传输对象，包含新增字段
     * @return AjaxResult 操作结果返回对象，包含成功或失败状态
     * @see CampusNewsDTO
     */
    @Log(title = "校园新闻管理", businessType = BusinessType.INSERT)
    @PostMapping("/add")
    public AjaxResult add(@Validated @RequestBody CampusNewsDTO dto) {
        dto.setUserId(getUserId().intValue());
        return toAjax(campusNewsService.insertCampusNews(dto));
    }

    /**
     * 修改已有校园新闻信息
     *
     * @param dto 前端传入的新闻数据传输对象，包含更新字段
     * @return AjaxResult 操作结果返回对象，包含成功或失败状态
     * @see CampusNewsDTO
     */
    @Log(title = "校园新闻管理", businessType = BusinessType.UPDATE)
    @PostMapping("/edit")
    public AjaxResult edit(@Validated @RequestBody CampusNewsDTO dto) {
        CampusNewsDTO newsDTO = BeanDtoVoUtil.convert(dto, CampusNewsDTO.class);
        return toAjax(campusNewsService.updateCampusNewsById(newsDTO));
    }

    /**
     * 删除指定ID的新闻信息
     *
     * @param newsId 要删除的新闻唯一标识符
     * @return AjaxResult 操作结果返回对象，包含成功或失败状态
     * @see CampusNewsDTO
     */
    @Log(title = "校园新闻管理", businessType = BusinessType.DELETE)
    @GetMapping("/del")
    public AjaxResult del(@ApiParam(value = "新闻ID", required = true) Integer newsId) {
        return toAjax(campusNewsService.deleteCampusNewsById(newsId));
    }
}
